home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / internet / iccchess.zip / TMSTAMP.TXT < prev    next >
Text File  |  1995-11-20  |  10KB  |  202 lines
  1. INSTRUCTIONS FOR USING TMSTAMP and TMSEAL           ---draft November 1995---
  2.                                     ---send comments to dfong@igc.apc.org---
  3.  
  4. This document explains how to use TMSTAMP with SLICS or other ICS clients.
  5. Please read it carefully.  Except where noted, the same instructions also
  6. apply to TMSEAL.
  7.  
  8. TMSTAMP is the Windows version of ICC's timestamp program.  It runs under
  9. Windows 3.1 using Winsock SLIP/PPP.  You must be running SLIP/PPP to use
  10. TMSTAMP --- you cannot use TMSTAMP over a straight modem connection.
  11. (If you cannot use SLIP/PPP, your only option is to use one of the
  12. UNIX versions of timestamp.  See "help timestamp" and related helpfiles
  13. such as "help slics+timestamp".)
  14.  
  15. Some users have also reported success using TMSTAMP under OS/2 and Win95. 
  16. Your mileage may vary.  [TMSEAL is the Windows version of FICS timeseal.
  17. The programs are different because the ICC and FICS servers use different
  18. protocols, however the way you use them is the same.]
  19.  
  20. TMSTAMP INSTALLATION.
  21. First you must install TMSTAMP.  Put the TMSTAMP executable in the same
  22. directory as your ICS client program.  Create a program manager icon for it
  23. with File|New under the program manager.  (Click "New Program Item".  Set
  24. the "Command line" to "tmstamp".  Set the "Starting directory" to the name
  25. of the directory where you put the TMSTAMP executable.  You may check the
  26. "Run minimized" checkbox if you wish.)
  27.  
  28. Note that you do not need to provide the hostname or internet address of the
  29. server: it is built in to TMSTAMP.  [Similarly for TMSEAL, you do not need to
  30. supply the hostname of the FICS server, because there is (currently) only
  31. one FICS server that implements the timeseal protocol, and that is built
  32. in to TMSEAL.]
  33.  
  34. STARTING TMSTAMP - MANUAL LAUNCH.
  35. There are 2 ways to launch TMSTAMP: manual or automatic.  The manual
  36. launch method will work with any client program; the automatic method
  37. works with SLICS, and may work with other client programs later.
  38. To launch TMSTAMP manually, simply double-click on its icon.
  39.  
  40. Now TMSTAMP has been started.  It is waiting for your client program
  41. to connect to it.  Start your client program and tell it to connect to
  42. the host "localhost" (literally, l o c a l h o s t) instead of the
  43. chess server "chess.lm.com".  The reason for this is that TMSTAMP works
  44. by posing as the chess server to your client program.  Your client program
  45. talks the "normal" ICS protocol to TMSTAMP; but under the covers, TMSTAMP
  46. is talking to the "real" chess server using the special timestamp protocol.
  47.  
  48. The usual communication pattern without TMSTAMP is:
  49.  
  50.     CLIENT_PROGRAM    <-->      ICC
  51.       on your PC            at chess.lm.com
  52.  
  53. The communication pattern with UNIX timestamp is:
  54.  
  55.     CLIENT_PROGRAM    <-->      timestamp           <-->     ICC
  56.        on your PC            on your UNIX machine        at chess.lm.com
  57.  
  58. The communication pattern with TMSTAMP is:
  59.  
  60.     CLIENT_PROGRAM    <-->      TMSTAMP           <-->     ICC
  61.       on your PC            also on your PC            at chess.lm.com
  62.                              aka "localhost"
  63.  
  64. STARTING TMSTAMP - AUTOMATIC LAUNCH WITH SLICS.
  65. If you are using SLICS version 2.1e or higher, you can login to ICC and
  66. launch TMSTAMP in one step by selecting the ICC-TMSTAMP profile entry
  67. from the ICS menu.  [for FICS, use the A-FICS-TMSEAL profile entry.]
  68. That's all there is to it.  If you are using an older version of SLICS,
  69. then either upgrade or use the "MANUAL LAUNCH" method.
  70.  
  71. NOTE: If you are using SLICS version 2.2a or higher, the details of the
  72. profile settings have changed.  If you are upgrading from 2.1e, you may
  73. have make some simple changes to your icsprofs.dat file.  The new variables
  74. are simpler to use.  See the file relnotes.txt in the SLICS distribution.
  75.  
  76. WHAT SHOULD HAPPEN NEXT.
  77. If all goes well, you should not have to do anything more.  Your client
  78. program should be connected to TMSTAMP running on localhost.  If this didn't
  79. work, try using the IP address 127.0.0.1 instead of the name localhost.
  80. (If you are using SLICS, edit the file "icsprofs.dat" and find the entry
  81. [ICC-TMSTAMP].  Then change the line under that entry that reads
  82. "icshost=localhost" to "icshost=127.0.0.1".)  If neither localhost nor
  83. 127.0.0.1 works, please read the sections "MORE HELP" and "REPORTING BUGS"
  84. below.  Netcom users, also read "NOTE FOR NETCOM USERS".
  85.  
  86. After your client program has connected to TMSTAMP, then TMSTAMP will
  87. try to connect to chess.lm.com [for FICS, chess.onenet.net] .  This may
  88. fail for the same reasons that ordinary connections to chess.lm.com fail,
  89. if the server is unavailable or unreachable for whatever reason.
  90. In any case, TMSTAMP will send status messages to the client program,
  91. and these messages should show up in the client program's telnet window.
  92.  
  93. IS IT WORKING?
  94. As you login, watch the server greeting messages.  If TMSTAMP is working,
  95. you should see a message "--> Move timestamping activated."  [On FICS,
  96. finger yourself; it should say "Timeseal: On" .]  Try using the ICC "ping"
  97. command on yourself.  [FICS does not yet have a "ping" command.]
  98.  
  99. ERRORS.
  100. If for some reason TMSTAMP generates an error, an error message will usually
  101. show up in your client program's telnet window.  In rare cases, there may
  102. be errors that will only show up in the TMSTAMP window.  You can see the
  103. message by un-minimizing the TMSTAMP window.  If you have a problem where
  104. the TMSTAMP window disappears before you can read the error message (this
  105. should not happen), you can turn turn on TMSTAMP logging by un-minimizing
  106. the TMSTAMP window beforehand and selecting File|Logging from the TMSTAMP
  107. main menu bar.
  108.  
  109. TMSEAL COMMAND LINE SYNTAX (does not apply to TMSTAMP).
  110. By default, TMSEAL connects to the main north american FICS server
  111. at caissa.onenet.net, port 5000.  You can specify a different server
  112. and portno on the command line.
  113.     tmseal [-p CLIENTPORT] [FICSHOST [HOSTPORTNO]]
  114. for example,
  115.     tmseal eics.daimi.aau.dk 5000
  116. connects to the european FICS.
  117. By default, TMSEAL listens on localhost port 5000 for a connection
  118. from your client program.  If you want, you can change this using the
  119. "-p CLIENTPORT" option.  Then (of course) tell your client program
  120. to connect to the CLIENTPORT port number.  This feature lets you run
  121. multiple tmseal connections to different servers, as long as you choose
  122. a different CLIENTPORT for each instance of tmseal.
  123.  
  124. If you are using SLICS, you need to modify the "automatic launch"
  125.  
  126. TMSEAL EXPIRATION DATE (does not apply to TMSTAMP).
  127. The current state of TMSEAL is experimental.  Accordingly, the TMSEAL
  128. binary has an expiration date after which you must download a new version. 
  129. The purpose of this restriction is only to force buggy versions out of
  130. circulation.  If you need a new version, then ftp to the caissa.onenet.net
  131. server, and look in the directory /pub/chess/Win3/ or
  132. /pub/chess/uploads/Win3/ , for a file named tmsl11?.zip , where ? is a
  133. character a-z.  I had intended to make the next release a non-experimental
  134. non-expiring version.  But it is taking longer than i expected to resolve
  135. the remaining problems.
  136.  
  137. NOTE FOR NETCOM USERS.
  138. NETCOM's implementation of Winsock has a bug which precludes using TMSTAMP. 
  139. All is not lost, however.  You can obtain Trumpet Winsock (or some other
  140. *real* Winsock implementation) and use it to dial in to NETCOM's service.
  141. You can use Trumpet to call up the NETCOM dialin number and login just like
  142. any other service provider.  Please read the file "help tmstamp+netcom"
  143. on ICC, or the file "netcom.txt" in the SLICS distribution.  If you need
  144. assistance with logging in to NETCOM, ask netcom technical support.
  145. If you're an ICC member, you can also message arcsin for help.  If you need
  146. assistance with Trumpet, ask Trumpet technical support.
  147.  
  148. NOTE FOR OS/2 USERS.
  149. If you can't connect to "localhost" or "127.0.0.1", it may help to add
  150. the following line to your OS/2 config.sys file.
  151.     RUN=d:\tcpip\bin\ifconfig.exe lo 127.0.0.1
  152.  
  153. NOTE FOR WIN95 USERS.
  154. If you get errors using the Win95 sockets, try using Trumpet instead.
  155. Trumpet will probably work better.  Yes, you *can* use Trumpet under Win95.
  156.  
  157. NOTE FOR NOVELL USERS.
  158. Some users of Novell Winsock have reported problems.  If you are using
  159. Novell Winsock and can get TMSTAMP working, please let me know.
  160.  
  161. NOTE FOR FTP WINSOCK USERS.
  162. A user of FTP Winsock reported sometimes FTP Winsock fails unexpectedly
  163. during name lookup.  If this happens to you, try using the numeric
  164. IP address instead.  (See "TMSEAL COMMAND LINE SYNTAX" above.)
  165. Also, if you cannot connect to localhost using IP address 127.0.0.1,
  166. it has been reported that it will work to use your true IP address,
  167. ie, the address assigned to your PC for SLIP or PPP usage.  If you
  168. are using SLICS version 2.2a or later, put the line
  169.     localhost=...
  170. in your chessbd.ini file, where the ... is your true IP address.
  171. The default is 127.0.0.1 .
  172. Thanks to Ursus von Bemmelen for sharing this information.
  173.  
  174. REGISTRATION.
  175. You do not need to register TMSTAMP or TMSEAL.  They are freeware ---
  176. not shareware.  Do not send or offer money for TMSTAMP and/or TMSEAL.
  177. On the other hand, SLICS is shareware.  That means if you are using SLICS
  178. you are honor bound to make a contribution.  The same thing goes for
  179. any other shareware program.
  180.  
  181. MORE HELP.
  182. If after reading this document, you still have problems getting started
  183. with TMSTAMP, then please message arcsin on ICC or send email to
  184. icc@chess.lm.com .  [If you have problems with TMSEAL, please message one
  185. of the FICS admins.]  But before asking for help, please try to verify where
  186. the problem lies.  Try using your standard TCP/IP "telnet" app to contact
  187. the internet address of the server.
  188.     telnet chess.onenet.net 5000
  189. -If- telnet works, then so should TMSTAMP.  -Or- if telnet doesn't work,
  190. then you are having a Winsock or SLIP/PPP problem that has nothing to do
  191. with TMSTAMP; you must resolve that problem before you can expect TMSTAMP
  192. to work.  Ask your s/w vendor for help with Winsock problems.  Ask your
  193. service provider for help with SLIP/PPP problems.
  194.  
  195. REPORTING BUGS.
  196. If you find a bug in TMSTAMP or TMSEAL, send email to dfong@igc.apc.org .
  197. Please use the bug reporting form included in the distribution.
  198. Please send email, not ICC or FICS messages.
  199.  
  200. --- Don Fong (dfong@igc.apc.org)
  201.  
  202.